Description:

Overview

Adds support for running tests with Bun's native test runner while maintaining full compatibility with Vitest. Provides a compat layer for Vitest-specific APIs and documents the scope of what works in both runners.

Closes #120

Changes

• Implemented compat layer in test/setup.ts for Vitest-only mocking APIs
• Added unstubAllGlobals(), stubGlobal(), createMockFn() and other mock utilities
• Marked vi.mock()-dependent tests to skip in Bun:
  • test/chains/stellar/announcements.test.ts
  • test/chains/stellar/asset.test.ts
• Comprehensive documentation in test/README.md with API scope table and examples

Vitest vs Bun Support

✅ Supported in Both

• describe(), it(), test(), describe.skipIf(), it.skipIf()
• beforeEach(), afterEach()
• expect() with all assertions
• Standard Node globals

⚠️ Supported with Compat Stubs

• vi.fn() → createMockFn()
• vi.stubGlobal() → stubGlobal()
• vi.clearAllMocks() → clearAllMocks()
• vi.restoreAllMocks() → restoreAllMocks()
• vi.resetAllMocks() → resetAllMocks()
• vi.unstubAllGlobals() → unstubAllGlobals()
• vi.useRealTimers() → useRealTimers() (no-op in Bun)

❌ Not Supported in Bun

• vi.mock() / vi.unmock() — Tests skipped when Bun detected
• vi.spyOn()
• vi.fake.timers()
• vi.hoisted()
• Snapshot testing

Performance

• Bun's runner is ~2-3x faster than Vitest for I/O-bound tests
• CI already runs both in parallel matrix

Files Modified

• test/setup.ts - Compat layer with mock utilities
• test/chains/stellar/announcements.test.ts - Skip in Bun
• test/chains/stellar/asset.test.ts - Skip in Bun
• test/README.md - Complete API scope documentation

Usage

import {
  describe, it, expect,
  createMockFn,
  stubGlobal,
  clearAllMocks,
  unstubAllGlobals,
} from './setup';

const isBun = typeof Bun !== 'undefined';

describe.skipIf(isBun)('Vitest-only', () => {
  it('uses vi.mock()', () => {
    // Only runs in Vitest
  });
});

describe('Compatible', () => {
  it('uses compat layer', () => {
    const mock = createMockFn(() => 'result');
    expect(mock()).toBe('result');
  });
});